\p 



Lid 



PRO-LOG 

CORPORATION 






STD 7000 

MP4 

Keyboard Monitor 

USER'S MANUAL 




o 



o 



NOTICE 

The information in this document is provided for reference only. Pro-Log does not assume any liability arising 
out of the application or use of the information or products described herein. 

This document may contain or reference information and products protected by copyrights or patents and 
does not convey any license under the patent rights of Pro-Log, nor the rights of others. 

Printed in U.S.A. Copyright© 1981 by Pro-Log Corporation, Monterey, CA 93940. All rights reserved. However, 
any part of this document may be reproduced with Pro-Log Corporation cited as the source. 



c 



PROGRAM 
MP-4 KEYBOARD MONITOR 



THIS PROGRAM IS INTENDED FOR USE 

or 7803 (Z80) cpu boards and the 



m 



THE PRO-LOG 7801 (8085) 

keyboard/display card. 



IT provides the user with a monitor and debugging program that 

RESIDES IN A 2716 EPROM, FROM ADDRESS 0000 HEX TO 0/FF HEX. 

THE PROGRAM ALSO PROVIDES THE USER WITH SEVERAL INDEPENDENTLY 
ACCESSIBLE PROGRAM MODULES (SUBROUTINESO THAT CAN BE CALLED 
BY THE USER OR MOVED INTO HIS PROGRAMS. THESE INCLUDE MODULES 
TO ALLOW HIM TO FULLY EXERCISE THE 7303 KEYBOARD AND APLHA- 
NUMERIC DISPLAYS. 

IN ADDITION, THE CAPABILITY TO TRANSFER DATA FROM A PRO-LOG 
PROM PROGRAMMER TO THE USER S SYSTEM, OR VICE VERSA, IS PRO- 
VIDED WHEN UTILIZED IN CONJUNCTION WITH A PIN-J.M PARALLEL 
INTERFACE TO PROM PROGRAMMER. 
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MP-4 KEYBOARD 
MONITOR PROGRAM 



General 

The MP-4 Keyboard Monitor Program is intended to be a program development aid 
and program debugging tool for the STD BUS user. It is designed to be used 
with the PRO-LOG 7303 Keyboard/Display Card as the I/O device and a 7801 (8085) 
or 7803 (Z80) CPU Card. It is fully compatible and useable with the PRO-LOG 
M900, M900B, M920 and M980 PROM Programmers as well as the M824 and M825 System 
Analyzers. In addition to providing the user with several useful editing and 
debugging functions, there are many resident, independently accessible program 
modules (subroutines) that may be called by the user or moved into his programs. 
These include routines to fully exercise the 7303 alpha-numeric displays and 
keyboard, a variable time delay module, and a Hex to ASCII conversion routine. 

The Monitor can also double as a diagnostic tool for the engineer or technician. 
When switches SI and S2 on the 7303 card are closed, or if the 7303 is not in 
place, program control is transferred to address 0800 Hex (ROM 1) and all monitor 
functions are bypassed. If the Monitor PROM is retained in the finished product, 
and if the user's permanent main program starts at address 0800 Hex, the Monitor 
program will be transparent until the 7303 is inserted into the rack and either 
or both switches are not closed. At that time, all Monitor functions will become 
available to allow debugging in place. 

Monitor resident software is provided to allow the user to transfer data from 
the microprocessor system to the PROM programmer and vice versa. This requires 
a PRO-LOG PROM Programmer equipped with the 9104, 9114, or 9814 Parallel Interface 
Option, and a PIN-114 Parallel Interface Option for STD BUS Prototyping Systems. 

System Requirements 

The Monitor program resides in one Intel 2716 EPR0M or equivalent and occupies 
addresses 0000 through 07FF Hex. Program parameters and stack operations use 
addresses 2000 through 204F Hex. User programs must start at locations which are 
not part of these address fields. In addition, all but the first two restart lo- 
cations are available to the user for vectored interrupt. However, the Non-Maskable 
locations 0024-0026 Hex (8085) and 0066-0068 Hex (Z80) are utilized in the program 
to cause the contents of the internal registers to be displayed in the 7303 dis- 
plays upon the occurrence of a Non-Maskable Interrupt (NMI). This interrupt can 
be generated coincident with any program address by the M824 or M825 System Ana- 
lyzers. 

Also, restart location 0038 Hex contains an unconditional jump to location 2020 
Hex in RAM. The user can program an unconditional jump into locations 2020-2022 
to vector his Restart 7 interrupt to any location in memory. 

With all RAM socketed on the 7801 or 7803 CPU Card, user programs and data may 
reside in address locations 0800-1FFF (ROM) or 2050-2FFF (RAM). Additional memory 
may be added (4000-FFFF) with the addition of PRO-LOG 7701 or 7702 memory boards. 
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The Monitor program utilizes the eight alpha-numeric displays and twenty-five 
keys provided on the 7303 Keyboard/Display Card. The keyboard is divided into 
a Hex key pad (keys 0-F), a system RESET key, and 8 function keys. Each key 
has a removable, transparent cap. Labels are provided with which the user may 
label each of the function keys (keys 10-17) by removing the cap, inserting the 
label, and replaceing the cap. A keyboard layout diagram is shown in Figure 1. 
to facilitate labeling. 
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Figure 1. 7303 Keyboard Labeling. 



Each of seven keys provides the capability of implementing the functions or 
commands so labeled, one upper and one lower function per key. To select an 
upper function, the user first depresses the shift key (t)> then the desired 
key. To select a lower function the user merely depresses the desired key. 
Operation is similar to that of many conventional hand-held calculators. 

The function keys are grouped by application. The horizontal row of function 
keys provide several data movement, manipulation and memory conditioning capa- 
bilities. The vertical column of function keys provide program development 
and debugging capabilities. 
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Upon power-on or pushbutton reset, the prompt word "READY?" is displayed in the 
7303 alpha-numeric displays. The subsequent selection of any command will result 
in the display being blanked, followed by the name of the command for approximately 
3/4 second. This verifies to the user that he has selected the desired function 
or command. Throughout several functions, the prompt word "BUSY" is displayed 
while the processor is completing the execution of that function. Several other 
prompt words are utilized by individual routines to enhance user entry or infor- 
mation. 

All Monitor routines are exited by depressing the "RESET" key, or upon completion 
of the function, in which case control is returned to the Monitor and "READY?" is 
again displayed. 

Monitor Operation 

To select a specific command, depress the appropriate combination of shift (f ) and 
function key. The display will blank and then the name of the function will appear 
centered in the display for 3/4 second. SST (Single Step), BST (Back Step), and 
CLR (Clear Entry) are not commands. 

All command functions except STR and RUN require the user to enter one or more 

4-digit Hex addresses. When an address entry is required, the prompt " " will 

be centered in the display. Enter the address, most significant digit first, from 
the hex keypad. As each digit is entered, it will be displayed, thereby replacing 
the prompt characters. After entering all 4 digits, depress SST. The address 
will disappear and the function will continue execution. 

Several commands (EDT, STR, FLM) may require the user to enter 2-digit Hex data. 
As before, enter the data from the Hex keypad, most significant digit first. The 
data will appear in the display as it is entered. At the completion of entry, 
depress SST and the function will continue execution. 

Should the user enter an address or data digit in error, it may be corrected by 
depressing the CLR key. Each time the CLR key is depressed, the next digit to 
the left will blank starting with the last entry. The digit(s) may then be re- 
entered. All corrections must be made before SST is depressed. 

During the course of the execution of the commands RCV, MOV and FLM, data is 
written into RAM. If the RAM location fails to accept the data, or ROM is written 
to, or the address written to does not exist in the system, then the execution of 
the function will halt and the address of the bad location and its data will be 
displayed. To abort further execution, depress RESET. To continue execution, 
depress SST. Execution will continue until completion, or until another bad loca- 
tion is encountered. 

A description of each command, its suggested application, and instructions for 
its utilization is included in the following pages. 



© 



f EDIT MEM J 



O 



YES 



Monitor Decre- 
ments Address 
to Next Lower 
Location. 



J 



YES 



Monitor Incre- 
ments Address 
to Next Higher 
Location. 



Monitor Displays 
ii H 

To Prompt an 
Address Entry. 



*User Enters a 
4-digit Hex 
Start Address 
From Keyboard, 



Monitor Displays 
Address and Data 
of Selected 
Location. 



*User Depresses 
SST, BST, or a 
Hex Key from 
Keyboard as Data, 




<D 



o 



YES 



*User Enters 
2nd Digit of 
Data from 
Keyboard. 



O 



8 







c 



EDT 



EDIT data in memory. 

This command allows the user to display a desired address and resident data in 
the 7303 alpha-numeric displays, and modify the data, if desired. After entering 
the desired starting address, the address and data will be displayed as 4 Hex 
digits of address and 2 Hex digits of data separated by 2 spaces (AAAA DD). 
The user may modify the data by merely depressing 2 Hex keys on the keyboard. 
The data will be displayed as it is entered, and will replace the original data. 
SST must be depressed to enter the data into memory, following data entry. 

If the user desires not to modifiy data, he may advance to the next higher location 
by depressing SST. At that time the address will be incremented and the address 
and data of the next location will be displayed. The user may also depress BST, 
thereby decrementing the address to the next lower location and display its address 
and data. 

To exit this command function, depress RESET. 

The purpose of this function is to allow the user to enter program and data into 
RAM for subsequent executuion and debugging. 

Note; If an "E" appears to the immediate left of the data, following a data entry, 
it informs the user that the data was not accepted, i.e., the RAM location is 
bad, or that area of memory is ROM or non-existent in the system. To continue, 
depress SST to increment to the next location. To abort, depress RESET. 
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Enter EXECUTION ADDRESS into memory. 

This command allows the user to enter a program execution starting address into 
memory and is intended to allow the user to exercise programs entered into RAM 
or ROM. 

Upon selection of this command, the Monitor will display the last execution ad- 
dress entered in the 7303 alpha-numeric displays for approximately one second. 

The display will then blank and the prompt " " will be displayed to indicate 

to the user that a new 4-digit Hex execution start address must be entered. The 
user may retain the current address by depressing RESET. Otherwise, the user 
enters the new address and depresses SST. 

After address entry, the display is blanked and then ,l *RUN* H is displayed. Tbe 
program may now be executed by depressing RUN. The execution address will be 
retained for subsequent program executions until it is changed by this command. 



RUN 



RUN the program at the previously entered execution address. 

This command will allow the user to execute a program in RAM or ROM, repeatedly. 
The execution start address is the last address entered via the XAD command. 
Upon selection of this command, the Monitor blanks the display and LED's, disables 
the keyboard, loads the registers with the values entered via the last STR command, 
retrieves the execution address from memory and jumps to that address. 
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Pre-SET Registers for program execution. 

This command allows the user to enter a set of initial register values into memory. 
Each time the user depresses RUN to commence execution of a program, or a portion 
of a program, these values will be loaded into the internal registers before jump- 
ing to that program. In this way, program execution can be started with the pro- 
cessor in a known state. The entered values will remain the same until changed by 
subsequent repetition of this command. 

Upon selection of this command function, the Monitor will display "REG H=dd", 
where "dd" is the last 2-digit Hex data entered for the initialization of the 
H register. To enter new data, depress the desired 2 Hex keys, then depress the 
SST key. To leave the data unchanged, depress the SST key directly. Each time 
the SST key is depressed, the next register name and content will be displayed. 
Depressing the SST key after the contents of the flag register, F, are displayed 
will return control to the Monitor, and "READY?" will be displayed. 

Register name and contents are displayed in the following order: 

H, L, D, E, B, C, A, F. 
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Set Breakpoint at user entered address. 

This command allows the user to enter a breakpoint at any desired address in a 
program that resides in RAM. When the breakpoint is encountered during program 
execution, the execution will terminate and the internal register contents will 
be displayed. 

Upon selection of this command function, the Monitor will display " " as an 

address prompt. Enter a 4-digit Hex address and depress the SST key. The Moni- 
tor will replace the original data at the designated address with a Restart 2 
(D7 Hex) and save the original data in memory. Upon depression of the SST key, 
control will be returned to the Monitor and "READY?" will again be displayed. 
Care must be taken to insure that the breakpoint only be set at an address that 
contains the first byte of an instruction. If this is not done, the restart 
instruction will be misinterpreted as operand data. 

Breakpoint Execution. 

Upon encountering a breakpoint, program execution will terminate and the register 
contents will be displayed, starting with "HL=dddd", where "dddd" is the 4-digit 
Hex data contained in the HL register pair. At this point, the user may change 
the data by entering 4 Hex digits of new data from the keyboard and depressing SST. 
The data will remain unaltered by directly depressing SST, at which time the next 
register pair name and data will be displayed in the same manner. Data is displayed 
in the following order: 

"HL=dddd", "DE=dddd", "BC=dddd", and "AF=dddd". 

After the AF register pair data is displayed, execution can be resumed by depressing 
SST. The Monitor will replace the restart instruction with the original data and 
execution will resume at the breakpoint address. To leave the breakpoint set for 
subsequent executions, depress RESET instead of SST. 

Non-Maskable Interrupt Service. 

Upon the occurrence of a non-maskable interrupt, the register pair contents will be 
displayed and can be altered as described above. However, the Monitor will not 
replace the breakpoint with original data. 
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Fill a block of memory with a single data value. 

This command allows the user to write the same data value into all RAM locations 
that lie between the user-entered address limits, inclusively. The data can be 
any user-entered 2-digit Hex value. 

Upon selection of this command function, the Monitor will prompt an address entry 

by displaying " ". Enter the starting address to be written to. The Monitor 

will prompt another address entry. Enter the ending address to be written to. 
The Monitor will now display "DATA?" to prompt a data entry. Enter a 2-digit 
Hex value from the keyboard. The data will be displayed as it is entered. Upon 
completion of the data entry, the Monitor will display "BUSY" while it writes the 
entered data into all locations within the address field. It then exits to RESET. 

This command may also be used to test the integrity of a block of RAM. Should any 
RAM location fail to accept the desired data, execution will halt and the bad 
location address and data will be displayed. Depressing SST will cause execution 
of the function to continue (See Monitor Operation). 

It is suggested to the user that prior to entering a program into RAM for develop- 
ment or debugging, the memory be filled with the data that corresponds to the un- 
programmed state of the PROM (00 or FF) in which it will eventually reside. Then, 
if the program is subsequently transferred to the PROM programmer via the SND com- 
mand, those areas of memory not actually part of the program will remain unprogram- 
in the PROM. 
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MOV 



Move a block of data to another location in RAM. 

This command allows the user to move any size block of data from ROM or RAM to 
another area of RAM. Both backward and forward moves are allowed. As the Moni- 
tor moves the data, it clears the source area by writing 00 Hex (NOP) into each 
source location. 

Upon selection of this command function, the Monitor displays " " to prompt 

an address entry. Enter the 4-digit Hex source starting address. Then the 
Monitor will prompt a second address entry. Enter the source ending address. 
The Monitor again prompts a third address entry. Enter the destination starting 
address. At the completion of the last entry, the Monitor will display "BUSY", 
and begin moving data to the new locations. If any location fails to accept 
the data, execution will halt and the bad location address and data will be dis- 
played. To resume execution, depress SST (see "Monitor Operation"). At the 
completion of the move, the Monitor will exit to RESET and display "READY?". 

This command can be used to move any Monitor software module into the user's 

program. The source start and end addresses, and the destination address are 

saved in memory for subsequent and repetitive address ajustment operations that 
utilize the AJA command. 
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Send a block of data to the PROM programmer. 

This command allows the user to transfer a block of memory data from either ROM 
or RAM to any PRO- LOG PROM Programmer equipped with a Parallel Interface Option. 
To use this command, the PIN-114 Prototyping System Interface to PROM Programmer 
must be installed to connect the microprocessor system to the programmer. When 
using an M900 or M920 programmer, only personality modules for PROMs with a 512 
word capacity, or greater, may be used. This restriction does not exist when 
using the buffer equipped M900B or M980 units. 

Upon selection of this command function, the Monitor determines if the PIN-114 is 
installed, if the programmer is connected, and if the programmer is turned on. 
If any of these conditions are not true, the Monitor displays "NO PGMR!" for one 
second, then exits to RESET and displays "READY?". 

If the programmer is on-line, depress the RESET key on the M900 or M900B program- 
mer to initiate the interlock. If an M920 is used, turn it of f, then on again. The 
M980 should not be RESET - the user must select Parallel Interface Option from the 
keyboard, initially. All but the M980 must be reset before each subsequent data 
transfer. 

Next, the Monitor will display " " as an address prompt. Enter a 4-digit Hex 

programmer buffer or PROM starting address. The Monitor will prompt a subsequent 
address entry. Enter the programmer buffer or PROM ending address. The Monitor 
will prompt a third address entry. Enter the microprocessor system starting address 
The Monitor will then display "BUSY" and transfer the block of data to the PROM 
programmer. Upon completion of the transfer, the Monitor will exit to RESET and 
display "READY?", after dropping the interlock signal. 



RCV 



Receive a block of data from the PROM programmer and store it in RAM. 

This command allows the user to transfer a block of data from the PROM programmer 
PROM or buffer to system RAM. All restrictions and interface requirements speci- 
fied for the SND command apply, as does the operating procedure. A further re- 
striction exists in that the data must be transferred to valid RAM locations. 
Should a RAM location fail to accept the data, or if the RAM capacitiy of the system 
is exceded, or if transfer is to ROM, then execution will stop and the address and 
data of the bad location will be displayed. Transfer may be resumed by depressing 
SST (see "Monitor Operation"). 
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Adjust the addresses contained in 3-byte instructions after a move 

Whenever a program or subroutine is moved from one area of memory to another, 
it will not execute correctly unless the addresses contained in all 3-byte 
Jump, Load, and Store instructions are changed to reflect the programs' s new 
location. This includes addresses contained within the moved program, and ad- 
dresses in other areas of memory that may refer to the moved program's original 
location. 

This command allows the user to adjust the move-affected addresses within any 
field of data. It may be used over as many fields as desired, and over any 
size data field. All adjustments made to addresses are based on the parameters 
of the last MOV operation, i.e., source start, source end, and destination start 
addresses. The Monitor determines the displacement (source minus destination), 
or how far the data was moved. It then searches for 3-byte instructions. The 
operand (2nd and 3rd bytes) of each instruction found is examined. If the operand 
value lies between the source start and end addresses, inclusive, the displacement 
is added or- subtracted from the operand. 

Upon selection of this command function, the Monitor displays " " as an address 

prompt. Enter the 4 Hex digit starting address of the field of data to be adjusted, 
The Monitor will then prompt a second address entry. Enter the 4 digit ending ad- 
dress of the data field. The Monitor will then display "BUSY" as it searches for 
3-byte instructions and adjust operands. Upon completion, the Monitor exits to 
RESET and displays "READY?". 

NOTE: This command operates only on the subset of instructions common to both 
8085 and Z80. If Z80 special instructions are used, care must be taken 
to insure they are not altered by this routine. 
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Change all address bytes contained in 3-byte instructions. 

This command allows the user to change all page and line addresses contained in 
all 3-byte instruction operands within any area of RAM, by adding or subtracting 
an offset to those operands. The offset, or displacement, is computed by the 
Monitor from the source start and destination start addresses entered by the user. 
If the user has developed a program in RAM, and desires to relocate it to ROM, 
he can utilize this command to change the addresses of all Jump, Load and Store 
instructions that would be affected, then transfer the altered program to the 
PROM programmer. The converse is also true, in that the user can transfer the 
contents of a PROM to RAM, change all dependent addresses, and execute the pro- 
gram. 

Upon selection of this command function, the Monitor will prompt the entry of 

five (5) addresses by displaying " ". Enter the following 4 Hex digit addresses 

in the listed order: 

1) The starting address of the data whose operands are to be altered. 

2) The ending address of the data whose operands are to be altered. 

3) The source starting address, i.e. the starting address of the area 
in which the program was intended to operate. 

4) The source end address. 

5) The destination start address, i.e., the starting address of the 
area in which the user desires the program to execute. 

Upon completion of the last address entry, the Monitor will change all addresses 
required, while displaying "BUSY". When finished, the Monitor will exit to RESET 
and display "READY?". 

If the user wishes to change addresses in segments, in order to bypass data tables, 
the first area of data must be changed with the CHAD command, but subsequent areas 
may be changed with the AJA command. The source start, source end, and destination 
start address will be retained in memory until the next CHA operation. 

*This command operates on those instructions that are common to the 8085 and Z80. 
*If Z80 special instructions are used in the program, care must be taken to insure 
*they are not altered by this function. 
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Monitor/PROM Programmer Interface 

The Monitor program contains the necessary software to implement a direct parallel 
data interface with the M900, M900B, M920 and M980 PRO-LOG PROM Programmers. The 
M900 and M920 must be equipped with a 9104 Parallel Interface Option which is des- 
cribed in detail in Section 8 of the respective operating manuals. The M900B re- 
quires the 9114 Parallel Interface Option which is described in Section 11 of the 
operating manual. The M980 provides the 9814 Parallel Interface as described in 
Section 19 of the operating Manual. 

In addition, the PIN-114 Parallel Interface to PROM Programmer is required. This 
consists of a 7507 I/O Module Mounting Rack Inteface Card, an RC50-6 Ribbon Cable, 
and th$ 7140 Parallel Interface Adapter. To effect the interface, the 7507 must 
be inserted into the STD system rack, the 7140 inserted into the 25-pin "D" connec- 
tor of the PROM programmer, and the RC50-6 cable connected between them. 

Data is transferred to and from the PROM programmer via the SND and RCV commands of 
the Monitor. The user has the choice of programming PROMs with debugged machine 
code directly from the system, or transferring ROM based programs/subroutines into 
the system for subsequent modification/debugging. 
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The following diagrams describe the port/bit assignments of the PIN-114: 
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All handshake lines are active when low, i.e., 1 = low, = high. 



Definitions: [T = Transfer* 
to J M = Mode* 
pgmrA I = Interlock* 
I = constant 



^"+5v = programmer power 
from! A = Address* 
pgmr.N E = Error (not used by Monitor) 

V. R = Response* 
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Monitor Use with M900B or M980 PROM Programmer 

The most serious drawback to a RAM based development tool is the volatility 
of the memory. All too often, RAM based programs are altered or destroyed by 
electrical noise, power fluctuations, or program bugs that overwrite the program. 

The M900B and M980 PROM Programmers are equipped with CMOS RAM buffers that provide 
short to intermediate, power-off, data retention for several minutes to several 
days. These programmers may serve as a separate program storage medium that is 
totally immune to the electrical and software bugs that destroy programs. 

In order to prevent the total or partial loss of RAM based programs, it is recom- 
mended that the user always transfer his program into the programmer buffer before 
execution, modification or other debugging. In that way, a copy of the last valid 
program can rapidly be reloaded into RAM on request, even after programmer and 
system power are lost. It also provides the user with storage for earlier versions 
of his program, prior to modifications. Should his modification not work, he can 
easily retrieve the earlier version and try a different solution. 

Additionally, if the M900B or M980 is equipped with an appropriate interface option 
and is interfaced to other systems or I/O devices (CRT, TTY, computers, etc.), the 
programmer can serve as a temporary holding buffer. Data can be transferred from 
the interfaced device or system to the programmer, then transferred from the pro- 
rammer to the Monitor system for debugging or modification. 

Monitor Use with M824 or M825 Microprocessor System Analyzer 

The user may enhance the execution, debugging and diagnostic capabilities of the 
Monitor by combining its application with the added hardware diagnostic capabil- 
ities of the PRO-LOG M824 (Z80) or M825 (8085) Microprocessor System Analyzer. 
The analyzer performs the following basic functions: 

a. Tracks the actual instruction sequence as the program executes, 
and displays desired address, control and data information when 
it occurs. 

b. Monitors control states and data passing between the processor and the 
system it controls and allows the user to correlate actions or reactions 
with program execution. 

c. Provides a multi -qualified trigger to conventional oscilloscope when 
analog measurements are desireable. 

The analyzer allows the user to dynamically monitor his program, single step 
instruction-by-instruction or machine cycle-by -machine cycle through the program, 
stop the program execution at any address and machine cycle, capture data and 
stop the processor after any number of passes through an instruction sequence, 
and trigger an non-maskable interrupt upon the occurrence of any program address. 

The primary debugging capabilities of the Monitor include the ability to execute 
any program sequence with known register conditions on entry, and the ability 
to set a RAM based breakpoint, at which time the register contents are displayed 
and can be altered and execution resumed. 
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When used in conjunction with the analyzer's ability to stop the processor at any 
address and after any number of passes through the program sequence, the Monitor 
will permit the user to execute and exercise only those RAM and ROM based routines 
in which he is interested. This will allow him to independently exercise external 
hardware items controlled by the processor system, to diagnose and troubleshoot 
hardware problems, and to debug the integration of the software and hardware. 

Because the Monitor will display the contents of the internal registers upon the 
occurrence of a non-maskable interrupt, the analyzer's address-generated interrupt 
can be used to effect a breakpoint in ROM or RAM. The user merely sets the break- 
point address on the analyzer switches and arms the interrupt. When that address 
occurs on the address bus, the processor will be interrupted and its register con- 
tents displayed in the fashion discussed during the explanation of the BPT command. 

If the 7303 Keyboard/Display Card is not in place, the non-maskable interrupt rou- 
tine bypasses the register display routine. Instead the contents of the registers 
are pushed onto and pulled off of the stack and a return is executed. To see the 
register contents at any program location, place the analyzer in the STOP mode at 
location 0000 Hex. Set the desired address on the ADDRESS switches, set the CYCLE 
COUNT switch to Ml, the INSTRUCTION COUNT switch to 10 and ADDRESS + INSTRUCTIONS, 
and depress the INTERRUPT switch. Now depress CLEAR. The processor will stop at 
address 057B Hex and display F5. Single stepping from that point, cycle-by-cycle, 
will allow the user to see the registers being stored on the stack. The data dis- 
played will be as follows: 

F5, (A), (F), C5, (B), (C), D5, (D), (E), E5, (H), (L), ... 

where (r) means the contents of register r. (For a more in-depth discussion of the 
analyzer functions and capabilities, see the Users Manual for M824 (M825) System 
Analyzer .) 
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The following pages contain the Monitor program listing, main program flow charts, 
and pertinent memory maps. The source is written STD mnemonics, and utilizes only 
those instructions common to both the 8085 and Z80. An explanation of the mnemonics 
can be found on the PRO-LOG STD 8085 or Z80 PROCESSOR PROGRAMMING AIDS cards, in 
the USER MANUAL FOR M824 or M825 SYSTEM ANALYZER , and in the PRO-LOG MICROPROCESSOR 
USER'S GUIDE . The object or machine code listing is fully compatible for use with 
8080A, 8085, and Z80 microprocessors. When provided by PRO-LOG, the program is con- 
tained in one Intel 2716 EPROM, or equivalent, and resides in locations 0000 to 07FF, 
In addition, the following conventions are used throughout the program listing: 

a. Labels enclosed by apprentheses ( ) indicate subroutine entry points. 

b. Labels enclosed by brackets L J indicate Monitor command entry points. 

c. CST mnemonic implies location is a table data byte, vice instruction. 

The flowcharts utilize standard ANSI symbols. The program addresses that corres- 
pond to each flowchart element are written above the upper left shoulder of each 
sysmbol . If a routine that accomplishes a particular flowchart operation resides 
elsewhere in memory (subroutines, etc.) its address is written to the right of the 
symbol . 

Two memory maps are provided: 



2K ROM memory map. This map indicates the relative location in ROM of 
each routine, table, and unused area. 

1 Page memory map. This map indicates the relative location of each 
RAM variable or program parameter assigned for use by the Monitor. It 
also shows locations reserved for stack operation. All unassigned RAM 
space is available for user programs and data. 
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APPLICATION SOFTWARE 



MODULE DESCRIPTIONS 



The enclosed software module descriptions are intended to provide the user with 
all the information necessary to access, utilize or move the routines into his 
program. The modules described are totally independent of requirements of the 
Monitor program, and are intended to allow the user to fully exercise the capa- 
bilities of the 7303 Keyboard/Display Card. There are several other modules 
available to the user that are not described herein, because they were written 
to the specifications and tailored to the needs of the Monitor program. The 
user is encouraged to study the listings carefully, should he find it desire- 
able to utilize those modules. 
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M™.,.r- KUm,- (MESSAGE) 0680 

Module Name: ; : Fmtdv Arraeec. 



Entry Address:. 



Rinctional Description: 

This module allows the user to display a message in the alpha-numeric displays 
of the 7303 Keyboard/Display Card. The message can be any length and is dis- 
played in a billboard fashion, i.e., the message moves accross the display 
from right to left. A new character appears at the right each 200 milliseconds, 
and an old one disappears at the left. The message must be stored in memory, 
and can be any length. The first character of the message should be at the low 
address in the designated memory space and the end of the message at the high 
address. The message is stored as a string of 8-bit ASCII characters with parity 
bit either 1 or 0. The message body should be preceded by a string of 8 ASCII 
spaces and also followed by a string of 8 spaces. The last character of the 
message must be an FF Hex. 



Entry Requirements: 

Enter this module with the address of the first ASCII space that precedes the 
message in the HL register pair. 



Memory Space Occupied: 068 t0 69E 

Memory Requ irements : TOM: 3i Bytes RAM: Bytes 

REGISTERS ALTERED BY THIS ROUTINE: All registers are altered. 

Program Modules Utilized by this routine: 
(200 msec at), (display) 

Additional Comments: 



o 






o 
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(1 SEC AT); (500 MSEC AT); 06A8; 06Ag . 

tauLE Name: (200 msec at) ^ flnnRFR , ; Wbi 



Functional Description: 

These modules provide the user with delays of 1 second, 500 milliseconds, and 
200 milliseconds duration. The timing is approximate and based on the clock 
rates provided on PRO-LOG' s 7801 8085 CPU Card. For users of the 7803 Z80 
CPU Card, the delays are approximately 1.25 seconds, 625 milliseconds, and 
250 milliseconds duration. 



Entry Requirements: None. 



Memory Space Occupied: 06AB to 06B6 
^ Memory Requirements: RDM: 15 Bytes RAM: Bytes 

Registers Altered by this routine: b, c 

Program Modules Utilized by this routine: 

(LONG AT) 

Additional Comments: 



^ 
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MODUUNAHE: (FLASHER) ENTRY ADDRESS: ^ 



Functional Description: 

This module causes the user's desired cursor pattern to be displayed over the 
last displayed data or message for approximately 200 milliseconds (250 msecs. 
for Z80). All cursor segments are then turned off for approximately 500 milli- 
seconds (625 msecs. for Z80). The last displayed data or message is not changed. 
When the cursors are on, all LED's are also turned on, then turned off when the 
cursors are removed. The module can be used to flag the attention of an operator 
to the displayed message with a blinking pattern, by accessing this module in a 
repetitive loop. 



Entry Requirements: 

Enter this module with the desired cursor pattern as an 8-bit value in register D. 
Each bit (0-7) corresponds to a display position (0-7). If the bit is 1, the cursor 
segment is turned on; if the bit is 0, the cursor is turned off. 

Memory Space Occupied: 0700 to 0714 

Memory Requ irements : M: 21 Bytes RAM : Bytes 

Registers Altered by this RouTrNE: a,f 

Program Modules Utilized by this routine: 
(cursors), (clr cursors), (200 msec at), (500 msec at) 

Additional Comments: 



o 



o 
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ffcDULE HAME: (DISP4ASC);(DISPN) ^ AnnRF ^ 0718; 071A 

Functional Description: 

This multiple-entry module allows the user to display 4 or N (1 to 8) ASCII 
characters in the alpha-numeric displays on the 7303 Keyboard/Display Card. 
The ASCII data to be displayed must reside in sequential memory locations, 
the leftmost character at the low address and the rightmost at the high address 



Entry Requirements: 

Enter this module with the character count (01 to 08) in register C (DISP N only), 
the leftmost display position number in the lower three bits of register E, 
and the low order address of the display data table in the HL register pair. 

Memory Space Occupied: 0718 to 0724 
© Memory Requirements: TOM: 13 , Bytes RAM: Bytes 

Registers Altered by this routine: a, f, c, d, e, h, l 

Program Modules Utilized by this routine: 

(display) 

Additional Comments: 
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toULENAME: (DISP2NHEX) ENTRY ADDRESS: "" 



o 

Functional Description: 

This module allows the user to display the data contained in N (1 to 4) memory 
locations as 2-digit Hex numbers in the displays of the 7303 Keyboard/Display 
Card. The data stored at the low order address is displayed on the right, and 
data stored at the highest address is displayed in the leftmost desired positions. 



Entry Requirements: 

Enter this module with the number of memory locations to be displayed in register C, 
the rightmost desired display position number in the lower 3 bits of register E, 
and the low order address of the data in the HL register pair. 

Memory Space Occupied: 0727 to 072E 

Memory Requirements: RDM;_J Bytes RAM: Bytes 

Registers Altered by this routine: Aj f , c, d, e, h, l 

Program Modules Utilized by this routine: 

(DISP 2HEX) 

Additional Comments: 



^ur 
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Module Name: (disp 2hex) ^ Address:_!Z!L 



Functional Description: 

This module allows the user to display the contents of any desired memory location 
in the alpha-numeric displays of the 7303 Keyboard/Display Card. The data is dis- 
played as a 2 Hex digit number in 2 display positions. 



Entry Requirements: 

Enter this module with the address of the data to be displayed in the HL register pair, 
and the desired rightmost display position number in the lower 3 bits of register E. 

Memory Space Occupied: 072F to 073F 
g% Memory Requirements: CTi n , Bytes WW: Bytes 

Registers Altered by this routine: a, f, d, e, h, l 

Program Modules Utilized by this routine: 
(disp HEX) 

Additional Comments: 
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p^jLE NamF! (CLR CURSORS): (CURSO RS) ^ ^^ 0740; 0742 g 

Functional Description: 

This multiple-entry module allows the user to display different combinations 
of cursors in the alpha-numeric displays of the 7303 Keyboard/Display Card. 
The cursor character is a display character with all 16 segments turned on. 
It can be displayed over existing displayed data, then be turned off without 
altering the previously displayed data. Entry at the label (CLR CURSORS) turns 
off all cursors displayed. Entry at the label (CURSORS) causes any desired 
pattern of cursors on or off to be displayed in the 8 display positions. The 
pattern is contained in register D as an 8-bit binary number. Each bit position 
(0 to 7) corresponds directly with the 8 display positions (0 to 7). A bit set 
to 1 turns a cursor on; a bit set to turns a cursor off. 

Entry Requirements: 

Enter (CURSORS) with the desired cursor pattern in register D: 1 = on; = off. 
Enter (CLR CURSORS) directly. 

Memory Space Occupied: 0740 to 0759 

Memory Requirements: CTi 26 Bytes RAM: Bytes Q 

Registers Altered by this routine: a, f 

Program Modules Utilized by this routine: 

(STROBE) 

Additional Comments: 

For further information about the cursor control, see the 7303 USER'S MANUAL. 
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Module Name: (blank); (disp 8) Entky Address: m * 1 075D 
Functional Description: 

This multiple-entry module allows the user to display the same character in all 
8 displays of the 7303 Keyboard/Di splay Card. 

Entry at the label (BLANK) causes an ASCII space to be displayed, thereby blanking 
all 8 displays. 

Entry at the label (DISP 8) causes the ASCII character contained in register D to 
be displayed in all 8 displays. 



Entry Requirements: 

Enter (BLANK) directly. Enter (DISP 8) with the desired ASCII data to be displayed 
in register D. 

Memory Space Occupied: 075b to 0766 
© Memory Requirements: OT: 12 . Rvtfs RATI; Bytes 

Registers Altered by this routine: a, f, e 
Program Modules Utilized by "mrs routine: 

(DISPLAY) 

Additional Comments: 

For further information regarding the a Ipjia- numeric display control, see the 
7303 USER'S MANUAL. 



© 
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tt«UFN*g- (DISPHEX); (DISPLAY) ; ( STROBE |^ j^^, 0768; 076D; 0773 

Functional Description: 

This multiple-entry module is the primary display/control routine for the 7303 
alpha-numeric displays. 

Entry at the label (DISP HEX) causes the least significant 4 bits of Hex data in 
register D to be displayed in the display position whose number is contained in the 
lower three bits of register E. 

Entry at the label (DISPLAY) causes the ASCII data in register D to be displayed in 
the display position whose number is contained in the lower three bits of register E. 
The ASCII data can be of any parity. 

Entry at the label (STROBE) causes the write line one the selected display chip to 
be strobed from high to low to high. 

Entry Requirements: 

Enter (DISP HEX) with the Hex data to be displayed in the lower 4 bits of register D. 

Enter (DISPLAY) with the ASCII data to be displayed in register D. 

Enter both with the display position number in the lower 3 bits of register E. 

Enter (STROBE) with bit 2 of register E set to to strobe the right 4 displays, etc. 

Memory Space Occupied: 0768 to 077F 

Memory Requirements: ROM; 24 Fytes Rffl: Bytes 

Registers Altered by this routine: a, f, d (disp hex only) 

Program Modules Utilized by this routine: 
(hex ->- ascii) 

Additional Comments: 

For a more detailed description of the operation and control of the 7303 alpha- 
numeric displays, see the 7303 USER'S MANUAL . 
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Module Name: (Read i key); (read k bd) Address: 0780; Q78F 



Functional Description: 

The 7303 keypad is arranged as a 4 X 6 matrix, with the key faces and positions 
numbered in Hex fromm 00 to 17. This multiple-entry module detects, debounces 
and encodes a single key closure. Multiple key closures are ignored. Upon exit, 
the accumulator, register A, contains the encoded value of 00 to 17 that corres- 
ponds to the positional value of the depressed key. After entry into this module, 
the keyboard will continue to be scanned for a key closure until one occurs, at 
which time it will be processed and the routine exited. 

Entry at the label (READ 1 KEY) will cause only a single key closure to be processed, 
i.e., the key must be opened or released befor another closure can be processed. 

Entry at the label (READ KBD) will cause the routine to continuously process any 
key closure. 

Entry Requirements: None. 



Memory Space Occupied: 0780 to 07cf 

Memory Requirements: RDM: 80 _ Eytes RflH: Bytes 

Registers Altered by this routine: a, f 

Program Modules Utilized by this routine: 
(scan kbd): (debounce) 
Additional Comments : 

See the 7303 USERS MANUAL for more detail regarding the operation and control 
of the keyboard. 
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fa^ NAME: (SCAN ALL); (SCAN RB D) ^ ^^ 07D1, 07D6 

Functional Description: 

This multiple-entry module detects if any toggle switches or keys are closed. 

Upon exiting the routine, the zero flag reflects the keyboard/switch status. 
If Z = 0, a key or switch is closed. 

Entry at the label (SCAN ALL) detects the status of switches, then keys. 

Entry at the label (SCAN KBD) detects the status of the keys only. 



Entry Requirements: None. 



Memory Space Occupied: 07di to 07de 

Memory Requirements: ROM: 14 Bytes RflH: Bytes 

Registers Altered by this routine: a, f 

Progrm Modules Utilized by this routine: None. 

Additional Comments: 

See the 7303 USER'S MANUAL for a more detailed description of the operation and 
control of the toggle switches and keypad. 
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ta^ N^b: (hex-* ascii) tosS; 07E0 



Functional Description: 

This module converts the lower 4 bits of register A to an 8-bit ASCII equivalent, 
with parity bit set. Upon exit, the converted value is in register A. 



Entry Requirements: 

Enter this module with the Hex value to be converted in the lower 4 bits of 
register A. 

Memory Space Occupied: #750 to 07ec 

Memory Requ irements : ROM: * 3 Bytes WW: Bytes 

Registers Altered by this routine: Aj f 

Program Modules Utilized by this routine: None . 

Additional Comments: 
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Module Name: (debounce) bfm Address: J^ 

o 

Functional Description: 

This module implements a 20 millisecond (25 msec, for Z80) time delay for the 
debouncing of switches and keys, although it can be used for other purposes. 



Entry Requirements: None. 



Memory Space Occupied: 07ee to 07F6 

Memory Requirements: ROM; 9 Bytes RAM: Bytes 

Registers Altered by this routine: None. 

Program Modules Utilized by this routine: 
(long at) 
Additional Comments: 

The delay time of this module is based on the clock rates used with the 
PRO-LOG 7801 8085 CPU Card. Users of the 7803 Z80 CPU Card can expect 
a 25% increase in the delay time, due to the lower clock rate. 
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„ m (long at) 07f7 
Module Name: \ ^ ^55. 



Rjnctional Description: 

This module provides the user with a variable time delay routine. The delay is 
implemented by downcounting the contents of the BC register pair (16 bits) to 
zero. The delay time can be found from the relationship: 

AT = 24 N BC t + A t 

where t is the state time of the processor, N BC is the decimal count in BC, and A 
is the number of state times executed that are not in the delay loop itself. 
Therefore, the count for any time delay can be found from the relationship: 



N BC AT 24 " t A t . (N BC must be in Hex) 



Entry Requirements: 



Enter this module with the time delay count in the BC register pair as a 
16-bit binary value. 

Memory Space Occupied: 07F7 to 07ff 

Memory Requirements: ROM: 9 Bytes RAM: Bytes 

Registers Altered by this routine: b, c 

Progr/w Modules Utilized by this routine: None. 

Additional Comments: 

For the 8085, A = 29. For the Z80, A = 31. The longest time delay that can be 
handled by this routine is approximately 500 milliseconds, depending on the 
processor clock rate. 
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USER'S MANUAL 



m. PRO-LOG 

U(_J CORPORATION 



2411 Garden Road 
Monterey, California 93940 
Telephone: (408) 372-4593 

TWX: 910-360-7082 

Telex: 171879 
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